home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 1 Issue 2 / PDCD-1 - Issue 02.iso / _utilities / utilities / 001 / to24bpp / !To24bpp / !Help next >
Text File  |  1994-10-23  |  7KB  |  159 lines
  1. Help file for To24bpp
  2. ÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿ
  3.  
  4. This application is copyright Liam Gretton.
  5.  
  6. This is a simple utility with a cumbersome name for users who
  7. don't have RISC OS 3.5. It requires ChangeFSI 0.95 or greater.
  8. Acorn's Help application is supported.
  9.  
  10. It may run on Risc OS 2 machines... but this hasn't been tested.
  11.  
  12. If you are running this on a Risc PC, then why? Also, if you have
  13. Computer Concepts' graphics filters (currently available for
  14. TIFF, JPEG, PhotoCD and Clear files), then you don't need this
  15. program for those file formats.
  16.  
  17. To24bpp is primarily for users of ArtWorks or Impression Style
  18. or Publisher who wish to convert a 24 bit foreign file format to
  19. one of the new 16 or 24 bit sprite formats. ChangeFSI 0.95 can
  20. do this, but because RISC OS 3.1 doesn't support them,
  21. ChangeFSI falls over if you try to do the conversion in the
  22. desktop. From the command line, though, ChangeFSI will
  23. successfully output a 24 bit sprite, but it's a pain in the neck.
  24. To24bpp is therefore a simple desktop front-end for this
  25. particular feature of ChangeFSI.
  26.  
  27. To use the program, double-click on the !To24bpp icon, and it
  28. will install itself on the iconbar. You must ensure that the
  29. filer has 'seen' ChangeFSI beforehand. The program is controlled
  30. through its menu which looks like this...
  31.  
  32.  +----------+
  33.  | Info     |   Leads to a standard info box.
  34.  |          |
  35.  | Image  > |   Leads to a dialogue box giving some information
  36.  |          |   about the file.
  37.  | Save   > |   Leads to a save box.
  38.  |          |
  39.  | Quit     |   Quits the application.
  40.  +----------+
  41.  
  42. The Image and Save items are greyed out until a file has been
  43. dropped. The save box has three icons allowing you to select
  44. from a 256 grey-level sprite, or a new format 16- or 24-bit
  45. sprite. Dragging the sprite icon to a directory display or
  46. another application starts the conversion and saves the sprite.
  47. Filling in the writable field and clicking on the 'save' button
  48. also starts the process. Clicking on the 'cancel' button closes
  49. the menu and resets To24bpp to its virgin state.
  50.  
  51. For simplicity, none of the more advanced features of ChangeFSI
  52. are supported. However, once you've got your image into ArtWorks
  53. or Impression, you can flip it, rotate it and rescale it to your
  54. heart's content.
  55.  
  56. Only some filetypes are rejected by To24bpp, as ChangeFSI
  57. examines the contents of files if it doesn't recognise them
  58. immediately.
  59.  
  60. Sometimes if you try to save the sprite to an application, the
  61. conversion is carried out ok, but there's not enough memory for
  62. the app to load the sprite afterwards (this is most likely with
  63. JPEGs). You may find your converted sprite in Wimp$Scrap from
  64. where it can be recovered.
  65.  
  66. Not all errors reported are from To24bpp. Any errors from
  67. ChangeFSI are also reported (they're usually due to lack of
  68. memory).
  69.  
  70. Advanced options...
  71. You can alter the !Run file to tweak the program's operation.
  72. There are two variables used by ChangeFSI itself and one used by
  73. To24bpp. These are:
  74.  
  75. ChangeFSI$Cache      Used when converting JPEGs. If this is
  76.                      larger than the JPEG file size, conversion
  77.                      is considerably faster. The default is 128k.
  78.                      In practice, I have found that this must be
  79.                      set to a value large enough to accomodate
  80.                      the file, as ChangeFSI doesn't seem to be
  81.                      able to start up the djpeg routines from
  82.                      within To24bpp.
  83.  
  84. ChangeFSI$PCDIndex   Indicates which PhotoCD file is to be
  85.                      converted from the five versions available.
  86.                      Valid values range from 1 to 5. The default
  87.                      is 3 (base). I haven't been able to test
  88.                      PhotoCD conversion, and it may well fall
  89.                      over unless you have the support module
  90.                      which comes with Acorn's PhotoView.
  91.  
  92. ChangeFSI$Max        The maximum size of the output sprite held
  93.                      in memory before being output to disc. This
  94.                      is useful when very large files are to be
  95.                      converted. The default is 512k.
  96.  
  97. These variables can be changed at any time. For example, if you
  98. find that you don't have enough memory to convert a file, enter
  99. 'Set ChangeFSI$Max 100k' (or similar) at the command line and try
  100. saving again.
  101.  
  102. For more information on ChangeFSI$Cache and ChangeFSI$PCDIndex,
  103. refer to the file 'FSIinfo' in the ChangeFSI directory.
  104. ChangeFSI$Max allows To24bpp to use ChangeFSI's 'max' command.
  105. More details about this are also in the FSIinfo file.
  106.  
  107. Thanks are due to Jon Ribbens of DoggySoft for his excellent
  108. WimpExt module, and Alex Petrov of Moscow for his MenuUtils
  109. module. The templates were created using Dick Alsteinæs TemplEd.
  110. Oh yeah, and thanks to whomever wrote ChangeFSI, too.
  111.  
  112. If you find this at all useful, or if you find any bugs, or have
  113. any suggestions for improvement, please let me know!
  114.  
  115. Liam Gretton
  116. ljg2@leicester.ac.uk
  117.  
  118. 62 Berners Street      ...or...   18 Lyndhurst Avenue
  119. Leicester LE2 0AF                 River
  120. (until July 1995)                 Dover
  121.                                   Kent CT17 0LY
  122.  
  123. NOW FOR THE MUNDANE LEGAL BIT
  124. ÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿ
  125.  
  126. To24bpp is FREEWARE and I retain the copyright. It may be freely
  127. copied and distributed provided that all the original files are
  128. left intact. If you think it needs improving, don't distribute
  129. versions with your own adjustments - mail me and I'll fix the
  130. problem. PD libraries may distribute To24bpp for a nominal (ie
  131. minimal) fee to cover costs. I'm fed up with certain magazines
  132. and user groups selling 800k discs full of FREE software for
  133. ú2.00 or more. I take no responsibility for any loss of data,
  134. life or sanity. If To24bpp trashes your hard disc and blows up
  135. your monitor... well, I apologise, but don't say I didn't warn
  136. you.
  137.  
  138. The MenuUtils module is ⌐ Alex Petrov:
  139.                                Flat 107, Building 1
  140.                                29 Kavkazsky Boulevard
  141.                                Moscow
  142.                                115541
  143.                                RUSSIA
  144.                                
  145.                                APetrov@misis.msk.su
  146.                                APetrov@arm.msk.su
  147.  
  148. The WimpExt module is ⌐ Jon Ribbens of DoggySoft:
  149.                                DoggySoft
  150.                                Furzefield House
  151.                                Furzefield Road
  152.                                Beaconsfield
  153.                                Bucks.
  154.                                HP9 1PQ
  155.                                
  156.                                wxii@doggysft.demon.co.uk
  157.  
  158. The MsgTrans module is presumably ⌐ Acorn, and if I shouldn't be
  159. distributing it with this, sorry.